Crate econtext

econtext: fast and simple error context on panics.

Calling an econtext! macro adds a scope to a thread-local linked list. If there is a panic!() while the scope is active, the data/message provided to the econtext! macro will be printed.

This thus provides an opt-in stack trace with optional data (e.g. the values of function arguments).

This can be very useful, for instance:

• To print what data was being worked on when an error occurred
• To provide something similar to a stack trace where a real stack trace is not available (e.g. in some WASM contexts)
• To print a shorter and more readable stack trace for when the real stack trace is too long and winding.

The overhead of calling an excontext macro is around 15ns on a 2020 MacBook Pro.

Example

use econtext::*;

fn main() {
	econtext::add_panic_hook(); // Ensures econtext is printed on panic
	econtext!("While running"); // Print a message if there is a panic
	run();
}

fn run() {
	econtext_function!(); // Print function name (`run`) if there is a panic
	process("filename.txt");
}

fn process(filename: &str) {
	econtext_function_data!(filename.to_owned()); // Print function name and filename if there is a panic
	for i in 0..10 {
		econtext_data!("i", i); // Print loop index if there is a panic
		assert!(i != 4, "Intentional panic");
	}
}

On error, something like this is printed:

ERROR CONTEXT:
  my_module src/main.rs:17: i 4
  my_module src/main.rs:15: main::process "filename.txt"
  my_module src/main.rs:10: main::run
  my_module src/main.rs:5: While running

Macros

• current_function_name
• econtext
  Provide a single &'static str message as context.
• econtext_data
  Provide a &'static str and some data as context.
• econtext_function
  Provide current function name as context.
• econtext_function_data
  Provide current function name and some data as context.

Structs

• DataScope
  What is put in a stack frame that uses the macros.
• EmptyDebug
  Used internally when not having any data in a context scope.

Constants

• ERROR_STACK

Traits

• Entry
  The trait for an entry in the stack

Functions

• add_panic_hook
  Call this once to add a panic hook that calls print_econtext().
• econtext_string
  Returns the error context as a string.
• print_econtext
  Prints all active error contexts to stderr.
• type_name_of